Request for Comments: xxxx R. E. Moore FYI: xx IBM Networking Systems January 1994 Inclusion of SNA/MS Alert information in Traps Status of this Memo This memo provides information for the Internet community. It does not specify an Internet standard. Distribution of this memo is unlimited. Abstract. This RFC defines fault management objects to be transported in IBM enterprise-specific traps. The objects are compatible with the IBM SNA/Management Services generic Alert architecture. The RFC also indicates how the objects should be used when an agent sends traps to an IBM AIX SystemView NetView/6000 management station. Table of Contents 1.0 About this MIB module . . . . . . . . . . . . . . . . . . . 1 1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2 Scope of the MIB . . . . . . . . . . . . . . . . . . . . . . 2 1.3 Identification of Object Instances . . . . . . . . . . . . . 3 1.4 Access to Objects . . . . . . . . . . . . . . . . . . . . . 3 1.5 Representation of Alert Code Points as INTEGERs . . . . . . 4 1.6 The Date/Time (X'01') MS Common Subvector . . . . . . . . . 5 1.7 The Hierarchy/Resource List (X'05') MS Common Subvector . . 5 1.8 The Product Set ID (X'10') MS Common Subvector . . . . . . . 5 2.0 Definitions . . . . . . . . . . . . . . . . . . . . . . . . 8 3.0 Author's Address . . . . . . . . . . . . . . . . . . . . . 40 1.0 About this MIB module 1.1 Overview This MIB defines fault management objects to be transported in IBM enterprise-specific traps. The objects are compatible with the IBM SNA/Management Services generic Alert architecture. References to subvectors and subfields are provided to facilitate mapping to these architectures, if desired. For additional information on IBM SNA/Management Services, refer to the following IBM publications: Moore [Page 1] RFC xxxx IBM Fault Management MIB January 1994 o Systems Network Architecture Formats (GA27-3136) o SNA/Management Services Reference (SC30-3346). Traps containing these objects have been designed to enable a management station receiving such a trap to provide a network operator with a notification of a problem or impending problem, the problem type, description and probable cause, and recommended actions for problem resolution. The design also facilitates the conversion of the trap to an SNA/MS Alert major vector, which can be forwarded to an SNA/MS focal point. The following sections provide explanations of some of the subtleties of the MIB itself, and of the NetView/6000 applications supporting (1) local interpretation and display of the IBM enterprise-specific traps at the NetView/6000, and (2) conversion of the traps into SNA/MS generic Alerts, for forwarding to NetView. Together with the MIB itself, these sections should provide sufficient information for an SNMP agent to build IBM enterprise-specific traps that will be successfully processed at both NetView/6000 and NetView. 1.2 Scope of the MIB The MIB only provides objects for a subset of the Alert data defined by SNA/Management Services. Specifically, the MIB contains groups corresponding to the following Alert-specific and MS common subvectors: o Product Set ID (X'10') MS common subvector o Supporting Data Correlation (X'48') MS common subvector o Generic Alert Data (X'92') Alert MS subvector o Probable Causes (X'93') Alert MS subvector o User Causes (X'94') Alert MS subvector o Install Causes (X'95') Alert MS subvector o Failure Causes (X'96') Alert MS subvector o Detailed Data (X'98') Alert MS subvector Furthermore, not all of the elements or values defined for these subvectors by SNA/Management Services are reflected in the MIB. Examples include the Alert Type field in the Generic Alert Data subvector and several of the subfields defined for the Product Set ID subvector. When a trap is converted to an Alert and forwarded to NetView by the IBM AIX SystemView NetView/6000 management station, other subvectors Moore [Page 2] RFC xxxx IBM Fault Management MIB January 1994 are added to the Alert. How these additional subvectors are generated is the subject of 1.6, "The Date/Time (X'01') MS Common Subvector" on page 5, 1.7, "The Hierarchy/Resource List (X'05') MS Common Subvector" on page 5, and 1.8, "The Product Set ID (X'10') MS Common Subvector" on page 5. 1.3 Identification of Object Instances The following general rules describe how instances of the objects contained in this MIB are identified: o For elements such as Alert Type and Alert Description, which the SNA/MS Alert architecture allows to occur only once in a well-formed Alert major vector, only one instance of the corresponding object is allowed in a trap. This instance will always have an instance ID of 0. For example, the one instance of alertType present in a trap is identified by the object identifier { generic-Alert-Data 2 0 }. o For elements such as Probable Cause and User Cause, which the SNA/MS Alert architecture allows to appear multiple times in an Alert major vector, multiple instances of the corresponding object are allowed in a trap. All such objects have been incorporated into tables in this MIB. Each table includes a generic index column, which allows an order to be associated with the elements when they appear in a trap. The first row in each table has an index value of 1, the second row has a value of 2, and so on. The order of the rows in a table represents the semantics of the ordering of the corresponding elements in the Alert architecture, e.g., order of probability for Probable Causes, order in which actions are to be performed for Recommended Actions, or order in a hierarchy for Hierarchy/Resource List entries. For example, the first instance of userCause in a trap, corresponding to the User Cause with the highest probability, is identified by the object identifier { userCausesEntry 1 1 }. The second instance, corresponding to the User Cause with the next highest probability, is identified by the object identifier { userCausesEntry 1 2}, and so on for all of the remaining instances of userCause. 1.4 Access to Objects The purpose of this MIB is to define managed objects to be included in traps, so that the traps can contain information comparable to that present in the SNA/MS Alert major vector. In most cases it makes no sense for a manager to retrieve these objects with a GET operation, since the values of the objects can change each time a trap is sent. Even if an agent saves the most recent value of each Moore [Page 3] RFC xxxx IBM Fault Management MIB January 1994 object, these values will typically not all pertain to the same problem. Suppose, for example, that the most recent trap sent by an agent includes two Probable Causes (i.e., two instances of probableCause), whereas the preceding trap included four. A manager that walks the probableCausesTable will receive two values ({ probableCausesEntry 1 1 } and { probableCausesEntry 1 2 }) that pertain to the most recently reported problem, and two values ({ probableCausesEntry 1 3 } and { probableCausesEntry 1 4 }) that pertain to the previous problem. Worse, the manager has no way of knowing that this is the case, since there is nothing in the MIB to indicate which trap, and thus which problem, each object "belongs" to. In general, therefore, managers should not be retrieving the objects defined in this MIB, even though the objects are characterized as having read-only access. 1.5 Representation of Alert Code Points as INTEGERs Most of the information in an SNA/MS Alert major vector is carried in the form of short, language-independent code points. These code points serve an indexes into tables of national language-dependent text strings, which are stored at the receiver of the Alert major vector. The mappings between the code points and their corresponding English text strings appears in SNA Formats. In this MIB, the objects corresponding to the code points are defined with one of two syntaxes: INTEGER (0..255) for objects that correspond to one-byte code points, and INTEGER (0..65535) for those that correspond to two-byte code points. A manager receiving a trap containing one of these objects must insure that when the object is used to index a table of text strings, the correct entry is retrieved. Furthermore, both the agent sending a trap and the manager that receives and interprets it must insure that whatever their local representations for INTEGERs may be, the information content of each object is based on the representation of INTEGERs implicit in the MIB definitions. For example, the integer 161 (base-10) corresponds to the code point X'00A1', because it is equal to the integer 00A1 (base-16), regardless of whether the agent or the manager would ordinarily represent the integer 161 as X'00A1'. Statements in the MIB, such as those that tie the number and types of qualifiers associated with (the object corresponding to) a code point to the value of the "third hexadecimal digit" of the code point, always assume this particular representation for INTEGERs. Thus there is never an ambiguity as to what the third digit of the code point corresponding to a particular integer might be. Moore [Page 4] RFC xxxx IBM Fault Management MIB January 1994 1.6 The Date/Time (X'01') MS Common Subvector Since neither the trap itself nor the Fault Management MIB has provisions for time stamping, the Date/Time subvector must be added by NetView/6000 when it converts a trap into an Alert. Consequently the time reported in the Alert is that at which the conversion took place, rather than that at which the trap was created or sent. 1.7 The Hierarchy/Resource List (X'05') MS Common Subvector An Alert major vector contains hierarchy information to relate the resource that experienced the Alert condition to a network element that the Alert receiver has knowledge of. There is no provision in this MIB, however, for reporting any hierarchy information in a trap, since NetView/6000 provides a complete hierarchy when it maps a trap into an Alert. This hierarchy includes the SNA node name of the node where the NetView/6000 resides, the Service Point application name for the application performing the mapping, and the IP host name or address of the trap sender. Note that there is no provision for reporting the SNA identity (e.g., the control point name) of the trap sender, in the case where an SNA node sends a trap to NetView/6000. Since this information is needed when the Alert reaches NetView, or when the trap is processed and displayed locally by NetView/6000, the trap sender must find some other way to include it. The most logical choice is to include it as detailed data in the detailed-Data-SV group { alert 17 }. DataIDCodeDD values of use here include 130 (X'82') = CP, 131 (X'83') = PU, and 132 (X'84') = LU. When the trap is mapped to an Alert by NetView/6000, this SNA data ends up in the Detailed Data (X'98') subvector. When the Alert reaches NetView, the data is treated as detailed data rather than as hierarchy information, but at least it is available to the person or application interpreting and acting on the Alert. Since a trap sender cannot include hierarchy information in a trap, there is no reason for the Fault Management MIB to support indexing into hierarchy information. Consequently, there are no objects in the MIB corresponding to the Resource List Index (X'84') Network Alert common subfield. 1.8 The Product Set ID (X'10') MS Common Subvector In the SNA/MS Alert architecture, provision is made for two instances of the Product Set ID subvector in an Alert: o The Alert Sender PSID, which is mandatory, describes the products comprising the network element that sent the Alert. Moore [Page 5] RFC xxxx IBM Fault Management MIB January 1994 o The Indicated Resource PSID, which is conditionally present, describes the products comprising the network element that experienced the problem. If the same network element that experienced the problem sends the Alert, the the Indicated Resource PSID is omitted. If the Indicated Resource PSID is present, it must appear after the Alert Sender PSID in the Alert major vector. When NetView/6000 converts a trap into an Alert to forward to NetView, it assumes the role of the Alert sender. Consequently, it creates an Alert Sender PSID to identify itself, and places it first in the Alert major vector it is building. The information from the Fault Management MIB's product-Set-ID group { alert 3 } is then used to build an Indicated Resource PSID, which is placed second in the Alert major vector. The Alert architecture also makes provision for indexing of Product Set ID information from detailed data qualifiers. Because of this indexing, the sender of a trap must make allowance for the conversion process that will take place at NetView/6000. In an Alert, a Product Set ID index is a 1-byte field defined as follows: bits 0-3 A code point indicating to the Alert receiver which data from a Product Set ID is to be displayed. For example, this code might indicate that a hardware product's machine type or hardware product common name should be displayed. bit 4 An indication of whether the information to be displayed should come from the Alert Sender PSID (0) or the Indicated Resource PSID (1). This is where a trap sender must take into account that the information sent in the product-set-ID group { alert 3 } will appear in the Alert as the Indicated Resource PSID. bits 5-7 A binary count of which Product Identifier (X'11') subvector, of the indicated type (hardware or software) and from the indicated PSID, is to be indexed. When all three of the elements of the Product Set ID index are combined, the result is a values for one of the following OBJECT TYPES: productIDCodeSD, productIDCodeUC, productIDCodeIC, productIDCodeFC, and productIDCodeDD. For example, displayFirstHW(41) = X'29' = display machine type or hardware product common name (X'2') from the Indicated Resource PSID's (B'1') first hardware Product Identifier subvector (B'001'). When traps are processed and displayed locally by NetView/6000, the same rules apply for Product Set ID indexing. The values for the indexing objects are those that would point to the Indicated Resource Moore [Page 6] RFC xxxx IBM Fault Management MIB January 1994 PSID in an Alert if they were present in an Alert: displayFirstHW(41) = X'29', etc. Moore [Page 7] RFC xxxx IBM Fault Management MIB January 1994 2.0 Definitions IbmFaultMgmt-MIB DEFINITIONS ::= BEGIN IMPORTS alert FROM IBM-MIB -- alert = { iso org(3) dod(6) internet(1) private(4) -- enterprises(1) ibm(2) ibmArchitecture(5) alert(1) } DisplayString FROM RFC1213-MIB OBJECT-TYPE FROM RFC-1212; -- Groups in Fault Management MIB product-Set-ID OBJECT IDENTIFIER ::= { alert 3 } -- x10 subvector supporting-Data-Correl OBJECT IDENTIFIER ::= { alert 7 } -- x48 subvector generic-Alert-Data OBJECT IDENTIFIER ::= { alert 11 } -- x92 subvector probable-Causes OBJECT IDENTIFIER ::= { alert 12 } -- x93 subvector user-Causes OBJECT IDENTIFIER ::= { alert 13 } -- x94 subvector install-Causes OBJECT IDENTIFIER ::= { alert 14 } -- x95 subvector failure-Causes OBJECT IDENTIFIER ::= { alert 15 } -- x96 subvector detailed-Data-SV OBJECT IDENTIFIER ::= { alert 17 } -- x98 subvector ------------------------------------------------------------------------ -- The product-Set-ID group { alert 3 } (X'10' MS Common Subvector) -- -- This group is always present in a trap to describe the product -- encountering the condition being reported. -- ----------------------------------------------------------------------- ------------------------------------------------------------------------ -- hwProductInstallSpecificInfoTable (X'11' MS Common Subvector) ------------------------------------------------------------------------ hwProductInstallSpecificInfoTable OBJECT-TYPE SYNTAX SEQUENCE OF HwProductEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table containing information to identify hardware or microcode products. One or more entries in this table will be present in a trap." ::= { product-Set-ID 1 } hwProductEntry OBJECT-TYPE SYNTAX HwProductEntry Moore [Page 8] RFC xxxx IBM Fault Management MIB January 1994 ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "The information required to identify a single hardware product. The first entry identifies the product sending the trap. A second entry will be present in those traps reporting a condition in a product other than the trap sender." INDEX { genericIndexHW } ::= { hwProductInstallSpecificInfoTable 1 } HwProductEntry ::= SEQUENCE { productClassificationHW INTEGER, formatType INTEGER, machineType DisplayString, modelNum DisplayString, plantOfManufacture DisplayString, seqNum DisplayString, microcodeECLevel DisplayString, hardwareProdCommonName DisplayString, vendorIDhw DisplayString, genericIndexHW INTEGER } productClassificationHW OBJECT-TYPE SYNTAX INTEGER { hwIBM(1), -- (X'1') IBM hardware hwIBM-NonIBM(3), -- (X'3') IBM or non-IBM hardware -- (not distinguished) hwNonIBM(9) -- (X'9') non-IBM hardware } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code identifying the general classification of a product." ::= { hwProductEntry 1 } ------------------------------------------------------------------------ -- Hardware Product ID (X'00' Product ID Subfield) ------------------------------------------------------------------------ formatType OBJECT-TYPE SYNTAX INTEGER { form11(17) -- (X'11') product instance identified by plant of -- manufacture and sequence number (unique by machine -- type and model number) } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code identifying the format type of a product instance." ::= { hwProductEntry 2 } Moore [Page 9] RFC xxxx IBM Fault Management MIB January 1994 machineType OBJECT-TYPE SYNTAX DisplayString (SIZE (4)) -- numeric characters only ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "The machine type." ::= { hwProductEntry 3 } modelNum OBJECT-TYPE SYNTAX DisplayString (SIZE (3)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "Machine model number." ::= { hwProductEntry 4 } plantOfManufacture OBJECT-TYPE SYNTAX DisplayString (SIZE (2)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "Plant of manufacture." ::= { hwProductEntry 5 } seqNum OBJECT-TYPE SYNTAX DisplayString (SIZE (7)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "Sequence number: right justified, with ASCII 0's fill on left." ::= { hwProductEntry 6 } ------------------------------------------------------------------------ -- microcodeECLevel (X'0B' Product ID Subfield) ------------------------------------------------------------------------ microcodeECLevel OBJECT-TYPE SYNTAX DisplayString (SIZE (1..8)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "The Engineering Change (EC) level of the failing microcode component. This object is included in a trap only when the reported problem is most probably caused by a microcode failure." ::= { hwProductEntry 7 } ------------------------------------------------------------------------ -- hardwareProdCommonName (X'0E' Product ID Subfield) ------------------------------------------------------------------------ hardwareProdCommonName OBJECT-TYPE Moore [Page 10] RFC xxxx IBM Fault Management MIB January 1994 SYNTAX DisplayString (SIZE (1..15)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "The name commonly used to identify the product." ::= { hwProductEntry 8 } ------------------------------------------------------------------------ -- vendorIDhw (X'0F' Product ID Subfield) ------------------------------------------------------------------------ vendorIDhw OBJECT-TYPE SYNTAX DisplayString (SIZE (1..16)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "The name of the product vendor. This object is included in a trap only when the productClassificationHW object is set to 'hwNonIBM' or 'hwIBM-NonIBM'." ::= { hwProductEntry 9 } genericIndexHW OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { hwProductEntry 10 } ------------------------------------------------------------------------ -- swProductInstallSpecificInfoTable (X'11' MS Common Subvector) ------------------------------------------------------------------------ swProductInstallSpecificInfoTable OBJECT-TYPE SYNTAX SEQUENCE OF SwProductEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table containing information to identify software products. This table is present in a trap when the condition being reported is in a software product or set of software products." ::= { product-Set-ID 2 } swProductEntry OBJECT-TYPE SYNTAX SwProductEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "The information required to identify a single software product." INDEX { genericIndexSW } ::= { swProductInstallSpecificInfoTable 1 } Moore [Page 11] RFC xxxx IBM Fault Management MIB January 1994 SwProductEntry ::= SEQUENCE { productClassificationSW INTEGER, commonVerID DisplayString (SIZE (0..2)), commonRelID DisplayString (SIZE (0..2)), commonModID DisplayString (SIZE (0..2)), softwareProdCommonName DisplayString (SIZE (1..30)), softwareProdProgNmbr DisplayString (SIZE (0..7)), vendorIDsw DisplayString (SIZE (1..16)), genericIndexSW INTEGER } productClassificationSW OBJECT-TYPE SYNTAX INTEGER { swIBM(4), -- (X'4') IBM software swNonIBM(12), -- (X'C') non-IBM software swIBM-NonIBM(14) -- (X'E') IBM or non-IBM software -- (not distinguished) } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code identifying the general classification of a product." ::= { swProductEntry 1 } ------------------------------------------------------------------------ -- Software Product Common Level (X'04' Product ID Subfield) ------------------------------------------------------------------------ commonVerID OBJECT-TYPE SYNTAX DisplayString (SIZE (0..2)) -- Numeric characters only ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "Common version ID: right justified, with ASCII 0 fill on left." ::= { swProductEntry 2 } commonRelID OBJECT-TYPE SYNTAX DisplayString (SIZE (0..2)) -- Numeric characters only ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "Common release ID: right justified, with ASCII 0 fill on left." ::= { swProductEntry 3 } commonModID OBJECT-TYPE SYNTAX DisplayString (SIZE (0..2)) -- Numeric characters only ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "Common modification ID: right justified, with ASCII 0 fill on Moore [Page 12] RFC xxxx IBM Fault Management MIB January 1994 left." ::= { swProductEntry 4 } ------------------------------------------------------------------------ -- softwareProdCommonName (X'06' Product ID Subfield) ------------------------------------------------------------------------ softwareProdCommonName OBJECT-TYPE SYNTAX DisplayString (SIZE (1..30)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "The name commonly used to identify the product." ::= { swProductEntry 5 } ------------------------------------------------------------------------ -- softwareProdProgNmbr (X'08' Product ID Subfield) ------------------------------------------------------------------------ softwareProdProgNmbr OBJECT-TYPE SYNTAX DisplayString (SIZE (0..7)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "The program product number as assigned by distribution personnel, or a substitute value supplied by a user-written software program." ::= { swProductEntry 6 } ------------------------------------------------------------------------ -- vendorIDsw (X'0F' Product ID Subfield) ------------------------------------------------------------------------ vendorIDsw OBJECT-TYPE SYNTAX DisplayString (SIZE (1..16)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "The name of the product vendor. This object is included in a trap only when the productClassificationSW object is set to 'swNonIBM' or 'swIBM-NonIBM'." ::= { swProductEntry 7 } genericIndexSW OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { swProductEntry 8 } ------------------------------------------------------------------------ -- The supporting-Data-Correl group { alert 7 } (X'48' MS Common Subvector) Moore [Page 13] RFC xxxx IBM Fault Management MIB January 1994 -- This group is present in a trap when additional data is available -- that relates to the problem being reported. ------------------------------------------------------------------------ -- -- ------------------------------------------------------------------------ -- detailedDataSD (X'85' Supporting Data Correlation Subfield) ------------------------------------------------------------------------ detailedDataSDTable OBJECT-TYPE SYNTAX SEQUENCE OF DetailedDataSDEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table of information correlation data." ::= { supporting-Data-Correl 2 } detailedDataSDEntry OBJECT-TYPE SYNTAX DetailedDataSDEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "The information required by the trap receiver to correlate/retrieve additional data. All objects in this entry will be provided. The index is the instance/number of the correlator. Multiple entries will be provided when multiple sets of data are available." INDEX { genericIndexSD } ::= { detailedDataSDTable 1 } DetailedDataSDEntry ::= SEQUENCE { productIDCodeSD INTEGER, dataIDCodeSD INTEGER, dataEncodingSD INTEGER, dataSD OCTET STRING, genericIndexSD INTEGER } productIDCodeSD OBJECT-TYPE SYNTAX INTEGER { displayNone(0), -- X'00' displayFirstHW(41), -- X'29' displaySecondHW(42), -- X'2A' displayFirstSW(153), -- X'99' displaySecondSW(154) -- X'9A' } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code indicating what product identification, if any is to displayed in conjunction with the data-type and data. Moore [Page 14] RFC xxxx IBM Fault Management MIB January 1994 displayNone - Do not display any product identification data in conjunction with the data-type and data. displayFirstHW - display machine type or product common name from the first entry of the machineType or hardwareProdCommonName objects in the hwProductInstallSpecificInfoTable. displaySecondHW - display machine type or product common name from the second entry of the machineType or hardwareProdCommonName objects in the hwProductInstallSpecificInfoTable. displayFirstSW - display software product common name from the first entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable. displaySecondSW - display software product common name from the second entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable." ::= { detailedDataSDEntry 1 } dataIDCodeSD OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A Detailed Data code point (Data ID code point) (described in SNA Formats) indicating the type of data provided. The English text associated with each code point or its national language equivalent is displayed with the correlation data." ::= { detailedDataSDEntry 2 } dataEncodingSD OBJECT-TYPE SYNTAX INTEGER { hex(0), -- (X'00') encoded/displayed as hexadecimal digits binary(1), -- (X'01') encoded as an unsigned integer value, the -- decimal equivalent is displayed ascii(17) -- (X'11') data is to be decoded as ASCII characters } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code indicating how the accompanying correlation data is encoded, and thus how it is to be decoded and displayed." ::= { detailedDataSDEntry 3 } Moore [Page 15] RFC xxxx IBM Fault Management MIB January 1994 dataSD OBJECT-TYPE SYNTAX OCTET STRING (SIZE (1..44)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "Correlation data encoded as specified by the dataEncodingSD object." ::= { detailedDataSDEntry 4 } genericIndexSD OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { detailedDataSDEntry 5 } ------------------------------------------------------------------------ -- The generic-Alert-Data group { alert 11 } (X'92' Alert MS Subvector) -- -- This group is always provided in a trap to describe the problem being -- reported. ------------------------------------------------------------------------ flags OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory -- must be present in a trap DESCRIPTION "This object is always set to the value 0. It may be used in the future to further indicate why/when the trap was sent." ::= { generic-Alert-Data 1 } alertType OBJECT-TYPE SYNTAX INTEGER { perm(1), -- (X'01') permanent loss of availability temp(2), -- (X'02') temporary loss of availability perf(3), -- (X'03') performance is below an acceptable level pend(17), -- (X'11') impending loss of availability unkn(18) -- (X'12') the severity of the problem is not known } ACCESS read-only STATUS mandatory -- must be present in a trap DESCRIPTION "A code indicating the severity of the condition being reported." ::= { generic-Alert-Data 2 } alertDescriptionCode OBJECT-TYPE SYNTAX INTEGER (0..65535) Moore [Page 16] RFC xxxx IBM Fault Management MIB January 1994 ACCESS read-only STATUS mandatory -- must be present in a trap DESCRIPTION "An Alert Description code point (described in SNA Formats) denoting the problem being reported." ::= { generic-Alert-Data 3 } ------------------------------------------------------------------------ -- The probable-Causes group { alert 12 } (X'93' Alert MS Subvector) -- -- This group is always present in a trap to provide the probable -- cause(s) of the condition being reported. ------------------------------------------------------------------------ probableCausesTable OBJECT-TYPE SYNTAX SEQUENCE OF ProbableCausesEntry ACCESS not-accessible STATUS mandatory -- must be present in a trap DESCRIPTION "A table of probable cause data." ::= { probable-Causes 1 } probableCausesEntry OBJECT-TYPE SYNTAX ProbableCausesEntry ACCESS not-accessible STATUS mandatory -- must be present in a trap DESCRIPTION "An entry of probable cause data. The index is the number/instance of the probable cause." INDEX { genericIndexPC } ::= { probableCausesTable 1 } ProbableCausesEntry ::= SEQUENCE { probableCause INTEGER, genericIndexPC INTEGER } probableCause OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- must be present in a trap DESCRIPTION "A Probable Cause code point (described in SNA Formats) denoting a probable cause of the reported problem. From one to four instances of this object (in order of decreasing probability) are provided in a trap." ::= { probableCausesEntry 1 } genericIndexPC OBJECT-TYPE SYNTAX INTEGER Moore [Page 17] RFC xxxx IBM Fault Management MIB January 1994 ACCESS read-only STATUS mandatory -- must be present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { probableCausesEntry 2 } ------------------------------------------------------------------------ -- The user-Causes group { alert 13 } (X'94' Alert MS Subvector) -- -- This group provides data detailing the probable user causes of the -- problem and the recommended actions to be taken in connection with -- these causes. It may also provide additional detailed data to be -- inserted into the text indexed by the user cause and/or recommended -- action code points. -- -- This group is present in a trap if it possible that the problem can be -- resolved by an operator, without contacting any service organization. ------------------------------------------------------------------------ -- -- ------------------------------------------------------------------------ -- userCause (X'01' User Causes Subfield) ------------------------------------------------------------------------ userCausesTable OBJECT-TYPE SYNTAX SEQUENCE OF UserCausesEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table of user cause data." ::= { user-Causes 1 } userCausesEntry OBJECT-TYPE SYNTAX UserCausesEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "An entry of user cause data." INDEX { genericIndexUC } ::= { userCausesTable 1 } UserCausesEntry ::= SEQUENCE { userCause INTEGER, genericIndexUC INTEGER } userCause OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only Moore [Page 18] RFC xxxx IBM Fault Management MIB January 1994 STATUS mandatory -- optionally present in a trap DESCRIPTION "A User Cause code point (described in SNA Formats) denoting a probable user cause of the reported problem. From 0 to 4 instances of this object (in order of decreasing probability) are provided in a trap." ::= { userCausesEntry 1 } genericIndexUC OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { userCausesEntry 2 } ------------------------------------------------------------------------ -- recommendedActionsUC (X'81' Network Alert Common Subfield) ------------------------------------------------------------------------ recommendedActionsUCTable OBJECT-TYPE SYNTAX SEQUENCE OF RecommendedActionsUCEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table of recommended action data." ::= { user-Causes 2 } recommendedActionsUCEntry OBJECT-TYPE SYNTAX RecommendedActionsUCEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "An entry of recommended action data." INDEX { genericIndexRecommendedActionUC } ::= { recommendedActionsUCTable 1 } RecommendedActionsUCEntry ::= SEQUENCE { recommendedActionUC INTEGER, genericIndexRecommendedActionUC INTEGER } recommendedActionUC OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A Recommended Action code point (described in SNA Formats) denoting the recommended action to take to resolve the Moore [Page 19] RFC xxxx IBM Fault Management MIB January 1994 problem. From 0 to 4 instances of this object are provided in a trap, in the order in which the actions are to be performed. If an instance of the userCause object is present, at least one instance of this object will be present." ::= { recommendedActionsUCEntry 1 } genericIndexRecommendedActionUC OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { recommendedActionsUCEntry 2 } ------------------------------------------------------------------------ -- detailedDataUC (X'85' Network Alert Common Subfield) -- -- This subgroup is provided in a trap whenever detailed data is to be -- inserted into the text indexed by the user cause and/or recommended -- action code points. ------------------------------------------------------------------------ detailedDataUCTable OBJECT-TYPE SYNTAX SEQUENCE OF DetailedDataUCEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table of data to be inserted into the text indexed by the user cause and/or recommended action code points." ::= { user-Causes 3 } detailedDataUCEntry OBJECT-TYPE SYNTAX DetailedDataUCEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "The information required to display product identification, data type, and detailed data. The index is the instance/number of the detailed data. The following rules are used for providing entries: * An entry is provided for each instance of the userCause object and/or recommendedActionUC object containing a code point whose third hexadecimal digit is 'A' or 'B'. * Two entries are provided for each instance of the userCause object and/or recommendedActionUC object containing a code point whose third hexadecimal digit is 'C'. * Three entries are provided for each instance of the userCause Moore [Page 20] RFC xxxx IBM Fault Management MIB January 1994 object and/or recommendedActionUC object containing a code point whose third hexadecimal digit is 'D'. Entries are provided in the order of the occurrence of the code points requiring them." INDEX { genericIndexDetailedDataUC } ::= { detailedDataUCTable 1 } DetailedDataUCEntry ::= SEQUENCE { productIDCodeUC INTEGER, dataIDCodeUC INTEGER, dataEncodingUC INTEGER, dataUC OCTET STRING, genericIndexDetailedDataUC INTEGER } productIDCodeUC OBJECT-TYPE SYNTAX INTEGER { displayNone(0), -- X'00' displayFirstHW(41), -- X'29' displaySecondHW(42), -- X'2A' displayFirstSW(153), -- X'99' displaySecondSW(154) -- X'9A' } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code indicating what product identification, if any is to displayed in conjunction with the data-type and data. displayNone - Do not display any product identification data in conjunction with the data-type and data. displayFirstHW - display machine type or product common name from the first entry of the machineType or hardwareProdCommonName objects in the hwProductInstallSpecificInfoTable. displaySecondHW - display machine type or product common name from the second entry of the machineType or hardwareProdCommonName objects in the hwProductInstallSpecificInfoTable. displayFirstSW - display software product common name from the first entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable. displaySecondSW - display software product common name Moore [Page 21] RFC xxxx IBM Fault Management MIB January 1994 from the second entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable." ::= { detailedDataUCEntry 1 } dataIDCodeUC OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A Detailed Data code point (Data ID code point) (described in SNA Formats) indicating the type of data provided. The English text associated with each code point or its national language equivalent is displayed with the detailed data." ::= { detailedDataUCEntry 2 } dataEncodingUC OBJECT-TYPE SYNTAX INTEGER { hex(0), -- (X'00') encoded/displayed as hexadecimal digits binary(1), -- (X'01') encoded as an unsigned integer value, the -- decimal equivalent is displayed ascii(17) -- (X'11') data is to be decoded as ASCII characters } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code indicating how the accompanying detailed data is encoded, and thus how it is to be decoded and displayed." ::= { detailedDataUCEntry 3 } dataUC OBJECT-TYPE SYNTAX OCTET STRING (SIZE (1..44)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "Detailed data encoded as specified by the dataEncodingUC object." ::= { detailedDataUCEntry 4 } genericIndexDetailedDataUC OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { detailedDataUCEntry 5 } ------------------------------------------------------------------------ -- productSetIDIndexUC (X'83' Network Alert Common Subfield) Moore [Page 22] RFC xxxx IBM Fault Management MIB January 1994 -- -- This subgroup is provided in a trap whenever product identification -- data is to be inserted into the text indexed by the user cause and/or -- recommended action code points. ------------------------------------------------------------------------ productSetIDIndexUCTable OBJECT-TYPE SYNTAX SEQUENCE OF ProductSetIDIndexUCEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table a describing how product identification data will be inserted into the text indexed by the user cause or recommended action code points." ::= { user-Causes 4 } productSetIDIndexUCEntry OBJECT-TYPE SYNTAX ProductSetIDIndexUCEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "An instance of information required to display product identification data. The index is the instance of the Product Set ID Index. An entry is provided for each instance of the userCause object and/or recommendedActionUC object containing a code point whose third hexadecimal digit is 'E'. Entries are provided in the order of the occurrence of the code points requiring them." INDEX { genericIndexPSIDIndexUC } ::= { productSetIDIndexUCTable 1 } ProductSetIDIndexUCEntry ::= SEQUENCE { productSetIDIndexUC INTEGER, genericIndexPSIDIndexUC INTEGER } productSetIDIndexUC OBJECT-TYPE SYNTAX INTEGER { displayFirstHW(41), -- X'29' displaySecondHW(42), -- X'2A' displayFirstSW(153), -- X'99' displaySecondSW(154) -- X'9A' } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "This object provides a code indicating how product identification data is to be inserted into the text indexed by the user cause and/or recommended action code points. displayFirstHW - display machine type or product common name Moore [Page 23] RFC xxxx IBM Fault Management MIB January 1994 from the first instance of the machineType or hardwareProdCommonName objects. displaySecondHW - display machine type or product common name from the second instance of the machineType or hardwareProdCommonName objects. displayFirstSW - display software product common name from the first entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable. displaySecondSW - display software product common name from the second entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable." ::= { productSetIDIndexUCEntry 1 } genericIndexPSIDIndexUC OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { productSetIDIndexUCEntry 2 } ------------------------------------------------------------------------ -- The install-Causes group { alert 14 } (X'95' Alert MS Subvector) -- -- This group provides data detailing the probable install causes of the -- problem and the recommended actions to be taken in connection with -- these causes. It may also provide additional detailed data to be -- inserted into the text indexed by the install cause and/or recommended -- action code points. -- -- This group is present in a trap if it possible that the problem could -- have been caused by an improper installation. ------------------------------------------------------------------------ -- -- ------------------------------------------------------------------------ -- installCause (X'01' Install Causes Subfield) ------------------------------------------------------------------------ installCausesTable OBJECT-TYPE SYNTAX SEQUENCE OF InstallCausesEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table of install cause data." Moore [Page 24] RFC xxxx IBM Fault Management MIB January 1994 ::= { install-Causes 1 } installCausesEntry OBJECT-TYPE SYNTAX InstallCausesEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "An entry of install cause data." INDEX { genericIndexIC } ::= { installCausesTable 1 } InstallCausesEntry ::= SEQUENCE { installCause INTEGER, genericIndexIC INTEGER } installCause OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "An Install Cause code point (described in SNA Formats) denoting a probable install cause of the reported problem. From 0 to 4 instances of this object (in order of decreasing probability) are provided in a trap." ::= { installCausesEntry 1 } genericIndexIC OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { installCausesEntry 2 } ------------------------------------------------------------------------ -- recommendedActionsIC (X'81' Network Alert Common Subfield) ------------------------------------------------------------------------ recommendedActionsICTable OBJECT-TYPE SYNTAX SEQUENCE OF RecommendedActionsICEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table of recommended action data." ::= { install-Causes 2 } recommendedActionsICEntry OBJECT-TYPE SYNTAX RecommendedActionsICEntry Moore [Page 25] RFC xxxx IBM Fault Management MIB January 1994 ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "An entry of recommended action data." INDEX { genericIndexRecommendedActionIC } ::= { recommendedActionsICTable 1 } RecommendedActionsICEntry ::= SEQUENCE { recommendedActionIC INTEGER, genericIndexRecommendedActionIC INTEGER } recommendedActionIC OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A Recommended Action code point (described in SNA Formats) denoting the recommended action to take to resolve the problem. From 0 to 4 instances of this object are provided in a trap, in the order in which the actions are to be performed. If an instance of the installCause object is present, at least one instance of this object will be present." ::= { recommendedActionsICEntry 1 } genericIndexRecommendedActionIC OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { recommendedActionsICEntry 2 } ------------------------------------------------------------------------ -- detailedDataIC (X'85' Network Alert Common Subfield) -- -- This subgroup is provided in a trap whenever detailed data is to be -- inserted into the text indexed by the install cause and/or recommended -- action code points. ------------------------------------------------------------------------ detailedDataICTable OBJECT-TYPE SYNTAX SEQUENCE OF DetailedDataICEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table of data to be inserted into the text indexed by the install cause and/or recommended action code points." ::= { install-Causes 3 } Moore [Page 26] RFC xxxx IBM Fault Management MIB January 1994 detailedDataICEntry OBJECT-TYPE SYNTAX DetailedDataICEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "The information required to display product identification, data type, and detailed data. The index is the instance/number of the detailed data. The following rules are used for providing entries: * An entry is provided for each instance of the installCause object and/or recommendedActionIC object containing a code point whose third hexadecimal digit is 'A' or 'B'. * Two entries are provided for each instance of the installCause object and/or recommendedActionIC object containing a code point whose third hexadecimal digit is 'C'. * Three entries are provided for each instance of the installCause object and/or recommendedActionIC object containing a code point whose third hexadecimal digit is 'D'. Entries are provided in the order of the occurrence of the code points requiring them." INDEX { genericIndexDetailedDataIC } ::= { detailedDataICTable 1 } DetailedDataICEntry ::= SEQUENCE { productIDCodeIC INTEGER, dataIDCodeIC INTEGER, dataEncodingIC INTEGER, dataIC OCTET STRING, genericIndexDetailedDataIC INTEGER } productIDCodeIC OBJECT-TYPE SYNTAX INTEGER { displayNone(0), -- X'00' displayFirstHW(41), -- X'29' displaySecondHW(42), -- X'2A' displayFirstSW(153), -- X'99' displaySecondSW(154) -- X'9A' } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code indicating what product identification, if any is to displayed in conjunction with the data-type and data. Moore [Page 27] RFC xxxx IBM Fault Management MIB January 1994 displayNone - Do not display any product identification data in conjunction with the data-type and data. displayFirstHW - display machine type or product common name from the first entry of the machineType or hardwareProdCommonName objects in the hwProductInstallSpecificInfoTable. displaySecondHW - display machine type or product common name from the second entry of the machineType or hardwareProdCommonName objects in the hwProductInstallSpecificInfoTable. displayFirstSW - display software product common name from the first entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable. displaySecondSW - display software product common name from the second entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable." ::= { detailedDataICEntry 1 } dataIDCodeIC OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A Detailed Data code point (Data ID code point) (described in SNA Formats) indicating the type of data provided. The English text associated with each code point or its national language equivalent is displayed with the detailed data." ::= { detailedDataICEntry 2 } dataEncodingIC OBJECT-TYPE SYNTAX INTEGER { hex(0), -- (X'00') encoded/displayed as hexadecimal digits binary(1), -- (X'01') encoded as an unsigned integer value, the -- decimal equivalent is displayed ascii(17) -- (X'11') data is to be decoded as ASCII characters } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code indicating how the accompanying detailed data is encoded, and thus how it is to be decoded and displayed." ::= { detailedDataICEntry 3 } Moore [Page 28] RFC xxxx IBM Fault Management MIB January 1994 dataIC OBJECT-TYPE SYNTAX OCTET STRING (SIZE (1..44)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "Detailed data encoded as specified by the dataEncodingIC object." ::= { detailedDataICEntry 4 } genericIndexDetailedDataIC OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { detailedDataICEntry 5 } ------------------------------------------------------------------------ -- productSetIDIndexIC (X'83' Network Alert Common Subfield) -- -- This subgroup is provided in a trap whenever product identification -- data is to be inserted into the text indexed by the install cause and/or -- recommended action code points. ------------------------------------------------------------------------ productSetIDIndexICTable OBJECT-TYPE SYNTAX SEQUENCE OF ProductSetIDIndexICEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table a describing how product identification data will be inserted into the text indexed by the install cause or recommended action code points." ::= { install-Causes 4 } productSetIDIndexICEntry OBJECT-TYPE SYNTAX ProductSetIDIndexICEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "An instance of information required to display product identification data. The index is the instance of the Product Set ID Index. An entry is provided for each instance of the installCause object and/or recommendedActionIC object containing a code point whose third hexadecimal digit is 'E'. Entries are provided in the order of the occurrence of the code points requiring them." INDEX { genericIndexPSIDIndexIC } ::= { productSetIDIndexICTable 1 } ProductSetIDIndexICEntry ::= SEQUENCE { Moore [Page 29] RFC xxxx IBM Fault Management MIB January 1994 productSetIDIndexIC INTEGER, genericIndexPSIDIndexIC INTEGER } productSetIDIndexIC OBJECT-TYPE SYNTAX INTEGER { displayFirstHW(41), -- X'29' displaySecondHW(42), -- X'2A' displayFirstSW(153), -- X'99' displaySecondSW(154) -- X'9A' } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "This object provides a code indicating how product identification data is to be inserted into the text indexed by the install cause and/or recommended action code points. displayFirstHW - display machine type or product common name from the first instance of the machineType or hardwareProdCommonName objects. displaySecondHW - display machine type or product common name from the second instance of the machineType or hardwareProdCommonName objects. displayFirstSW - display software product common name from the first entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable. displaySecondSW - display software product common name from the second entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable." ::= { productSetIDIndexICEntry 1 } genericIndexPSIDIndexIC OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { productSetIDIndexICEntry 2 } ------------------------------------------------------------------------ -- The failure-Causes group { alert 15 } (X'96' Alert MS Subvector) -- Moore [Page 30] RFC xxxx IBM Fault Management MIB January 1994 -- This group provides data detailing the probable failure causes of the -- problem and the recommended actions to be taken in connection with -- these causes. It may also provide additional detailed data to be -- inserted into the text indexed by the install cause and/or recommended -- action code points. -- -- This group is present in a trap if it possible that the problem could -- have been caused by the failure of a hardware or software component. ------------------------------------------------------------------------ -- -- ------------------------------------------------------------------------ -- failureCause (X'01' Failure Causes Subfield) ------------------------------------------------------------------------ failureCausesTable OBJECT-TYPE SYNTAX SEQUENCE OF FailureCausesEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table of failure cause data." ::= { failure-Causes 1 } failureCausesEntry OBJECT-TYPE SYNTAX FailureCausesEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "An entry of failure cause data. The index is the number/instance of the failure cause." INDEX { genericIndexFC } ::= { failureCausesTable 1 } FailureCausesEntry ::= SEQUENCE { failureCause INTEGER, genericIndexFC INTEGER } failureCause OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A Failure Cause code point (described in SNA Formats) denoting a probable failure cause of the reported problem. From 0 to 4 instances of this object (in order of decreasing probability) are provided in a trap." ::= { failureCausesEntry 1 } genericIndexFC OBJECT-TYPE SYNTAX INTEGER Moore [Page 31] RFC xxxx IBM Fault Management MIB January 1994 ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { failureCausesEntry 2 } ------------------------------------------------------------------------ -- recommendedActionsFC (X'81' Network Alert Common Subfield) ------------------------------------------------------------------------ recommendedActionsFCTable OBJECT-TYPE SYNTAX SEQUENCE OF RecommendedActionsFCEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table of recommended action data." ::= { failure-Causes 2 } recommendedActionsFCEntry OBJECT-TYPE SYNTAX RecommendedActionsFCEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "An entry of recommended action data." INDEX { genericIndexRecommendedActionFC } ::= { recommendedActionsFCTable 1 } RecommendedActionsFCEntry ::= SEQUENCE { recommendedActionFC INTEGER, genericIndexRecommendedActionFC INTEGER } recommendedActionFC OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A Recommended Action code point (described in SNA Formats) denoting the recommended action to take to resolve the problem. From 0 to 4 instances of this object are provided in a trap, in the order in which the actions are to be performed. If an instance of the failureCause object is present, at least one instance of this object will be present." ::= { recommendedActionsFCEntry 1 } genericIndexRecommendedActionFC OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap Moore [Page 32] RFC xxxx IBM Fault Management MIB January 1994 DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { recommendedActionsFCEntry 2 } ------------------------------------------------------------------------ -- detailedDataFC (X'85' Network Alert Common Subfield) -- -- This subgroup is provided in a trap whenever detailed data is to be -- inserted into the text indexed by the failure cause and/or recommended -- action code points. ------------------------------------------------------------------------ detailedDataFCTable OBJECT-TYPE SYNTAX SEQUENCE OF DetailedDataFCEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table of data to be inserted into the text indexed by the failure cause and/or recommended action code points." ::= { failure-Causes 3 } detailedDataFCEntry OBJECT-TYPE SYNTAX DetailedDataFCEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "The information required to display product identification, data type, and detailed data. The index is the instance/number of the detailed data. The following rules are used for providing entries: * An entry is provided for each instance of the failureCause object and/or recommendedActionFC object containing a code point whose third hexadecimal digit is 'A' or 'B'. * Two entries are provided for each instance of the failureCause object and/or recommendedActionFC object containing a code point whose third hexadecimal digit is 'C'. * Three entries are provided for each instance of the failureCause object and/or recommendedActionFC object containing a code point whose third hexadecimal digit is 'D'. Entries are provided in the order of the occurrence of the code points requiring them." INDEX { genericIndexDetailedDataFC } ::= { detailedDataFCTable 1 } DetailedDataFCEntry ::= SEQUENCE { Moore [Page 33] RFC xxxx IBM Fault Management MIB January 1994 productIDCodeFC INTEGER, dataIDCodeFC INTEGER, dataEncodingFC INTEGER, dataFC OCTET STRING, genericIndexDetailedDataFC INTEGER } productIDCodeFC OBJECT-TYPE SYNTAX INTEGER { displayNone(0), -- X'00' displayFirstHW(41), -- X'29' displaySecondHW(42), -- X'2A' displayFirstSW(153), -- X'99' displaySecondSW(154) -- X'9A' } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code indicating what product identification, if any is to displayed in conjunction with the data-type and data. displayNone - Do not display any product identification data in conjunction with the data-type and data. displayFirstHW - display machine type or product common name from the first entry of the machineType or hardwareProdCommonName objects in the hwProductInstallSpecificInfoTable. displaySecondHW - display machine type or product common name from the second entry of the machineType or hardwareProdCommonName objects in the hwProductInstallSpecificInfoTable. displayFirstSW - display software product common name from the first entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable. displaySecondSW - display software product common name from the second entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable." ::= { detailedDataFCEntry 1 } dataIDCodeFC OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION Moore [Page 34] RFC xxxx IBM Fault Management MIB January 1994 "A Detailed Data code point (Data ID code point) (described in SNA Formats) indicating the type of data provided. The English text associated with each code point or its national language equivalent is displayed with the detailed data." ::= { detailedDataFCEntry 2 } dataEncodingFC OBJECT-TYPE SYNTAX INTEGER { hex(0), -- (X'00') encoded/displayed as hexadecimal digits binary(1), -- (X'01') encoded as an unsigned integer value, the -- decimal equivalent is displayed ascii(17) -- (X'11') data is to be decoded as ASCII characters } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code indicating how the accompanying detailed data is encoded, and thus how it is to be decoded and displayed." ::= { detailedDataFCEntry 3 } dataFC OBJECT-TYPE SYNTAX OCTET STRING (SIZE (1..44)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "Detailed data encoded as specified by the dataEncodingFC object." ::= { detailedDataFCEntry 4 } genericIndexDetailedDataFC OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { detailedDataFCEntry 5 } ------------------------------------------------------------------------ -- productSetIDIndexFC (X'83' Network Alert Common Subfield) -- -- This subgroup is provided in a trap whenever product identification -- data is to be inserted into the text indexed by the failure cause and/or -- recommended action code points. ------------------------------------------------------------------------ productSetIDIndexFCTable OBJECT-TYPE SYNTAX SEQUENCE OF ProductSetIDIndexFCEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION Moore [Page 35] RFC xxxx IBM Fault Management MIB January 1994 "A table a describing how product identification data will be inserted into the text indexed by the failure cause or recommended action code points." ::= { failure-Causes 4 } productSetIDIndexFCEntry OBJECT-TYPE SYNTAX ProductSetIDIndexFCEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "An instance of information required to display product identification data. The index is the instance of the Product Set ID Index. An entry is provided for each instance of the failureCause object and/or recommendedActionFC object containing a code point whose third hexadecimal digit is 'E'. Entries are provided in the order of the occurrence of the code points requiring them." INDEX { genericIndexPSIDIndexFC } ::= { productSetIDIndexFCTable 1 } ProductSetIDIndexFCEntry ::= SEQUENCE { productSetIDIndexFC INTEGER, genericIndexPSIDIndexFC INTEGER } productSetIDIndexFC OBJECT-TYPE SYNTAX INTEGER { displayFirstHW(41), -- X'29' displaySecondHW(42), -- X'2A' displayFirstSW(153), -- X'99' displaySecondSW(154) -- X'9A' } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "This object provides a code indicating how product identification data is to be inserted into the text indexed by the failure cause and/or recommended action code points. displayFirstHW - display machine type or product common name from the first instance of the machineType or hardwareProdCommonName objects. displaySecondHW - display machine type or product common name from the second instance of the machineType or hardwareProdCommonName objects. displayFirstSW - display software product common name from the first entry of the Moore [Page 36] RFC xxxx IBM Fault Management MIB January 1994 softwareProdCommonName object in the swProductInstallSpecificInfoTable. displaySecondSW - display software product common name from the second entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable." ::= { productSetIDIndexFCEntry 1 } genericIndexPSIDIndexFC OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { productSetIDIndexFCEntry 2 } ------------------------------------------------------------------------ -- The detailed-Data-SV group { alert 17 } (X'98' Alert MS Subvector) -- -- This group is provided in a trap when there is product-specific -- detailed data to be reported. ------------------------------------------------------------------------ -- ------------------------------------------------------------------------ -- detailedDataDD (X'85' Network Alert Common Subfield) ------------------------------------------------------------------------ detailedDataDDTable OBJECT-TYPE SYNTAX SEQUENCE OF DetailedDataDDEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "A table of product-specific detailed data." ::= { detailed-Data-SV 1 } detailedDataDDEntry OBJECT-TYPE SYNTAX DetailedDataDDEntry ACCESS not-accessible STATUS mandatory -- optionally present in a trap DESCRIPTION "The information required to display product identification, data type, and detailed data." INDEX { genericIndexDD } ::= { detailedDataDDTable 1 } DetailedDataDDEntry ::= SEQUENCE { productIDCodeDD INTEGER, dataIDCodeDD INTEGER, Moore [Page 37] RFC xxxx IBM Fault Management MIB January 1994 dataEncodingDD INTEGER, dataDD OCTET STRING, genericIndexDD INTEGER } productIDCodeDD OBJECT-TYPE SYNTAX INTEGER { displayNone(0), -- X'00' displayFirstHW(41), -- X'29' displaySecondHW(42), -- X'2A' displayFirstSW(153), -- X'99' displaySecondSW(154) -- X'9A' } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code indicating what product identification, if any is to displayed in conjunction with the data-type and data. displayNone - Do not display any product identification data in conjunction with the data-type and data. displayFirstHW - display machine type or product common name from the first entry of the machineType or hardwareProdCommonName objects in the hwProductInstallSpecificInfoTable. displaySecondHW - display machine type or product common name from the second entry of the machineType or hardwareProdCommonName objects in the hwProductInstallSpecificInfoTable. displayFirstSW - display software product common name from the first entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable. displaySecondSW - display software product common name from the second entry of the softwareProdCommonName object in the swProductInstallSpecificInfoTable." ::= { detailedDataDDEntry 1 } dataIDCodeDD OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A Detailed Data code point (Data ID code point) (described in SNA Formats) indicating the type of data Moore [Page 38] RFC xxxx IBM Fault Management MIB January 1994 provided. The English text associated with each code point or its national language equivalent is displayed with the detailed data." ::= { detailedDataDDEntry 2 } dataEncodingDD OBJECT-TYPE SYNTAX INTEGER { hex(0), -- (X'00') encoded/displayed as hexadecimal digits binary(1), -- (X'01') encoded as an unsigned integer value, the -- decimal equivalent is displayed ascii(17) -- (X'11') data is to be decoded as ASCII characters } ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A code indicating how the accompanying detailed data is encoded, and thus how it is to be decoded and displayed." ::= { detailedDataDDEntry 3 } dataDD OBJECT-TYPE SYNTAX OCTET STRING (SIZE (1..44)) ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "Detailed data encoded as specified by the dataEncodingDD object." ::= { detailedDataDDEntry 4 } genericIndexDD OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory -- optionally present in a trap DESCRIPTION "A generic index to provide indexing for tables defining trap information. The value of this variable for the first row is 1, for the second row is 2, and so on." ::= { detailedDataDDEntry 5 } END Moore [Page 39] RFC xxxx IBM Fault Management MIB January 1994 3.0 Author's Address Robert E. Moore IBM Networking Systems P. O. Box 12195 Research Triangle Park, NC 27709 US Phone: +1 919 254 4436 Email: remoore@ralvm6.vnet.ibm.com Moore [Page 40]